home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / mcomm / mustread.doc < prev    next >
Encoding:
Text File  |  1994-10-02  |  5.5 KB  |  112 lines
  1.  
  2.  
  3.                             MCOMM ASYNC LIBRARY NOTES
  4.  
  5.             This file contains information on configuring the libraries
  6.          for use with your compiler and some Zortech C compiler specific
  7.          notes.  If your application may be ran on a system that uses a
  8.          Western Digital 16550, be sure and read the notes on this chip
  9.          in ASYNC.DOC.  The file, UPDATE.DOC, contains important
  10.          information regarding changes or additions to the library and
  11.          header files.  Be sure and read this file also.  The area code
  12.          for east Texas has been changed from 214 to 903 effective
  13.          November 1, 1990.  After May 1, 1991, the old area code will no
  14.          longer work.  The new numbers are:
  15.  
  16.             North East Texas Data Link    (903) 838-6713
  17.             Mike Dumdei (voice)           (903) 838-8307
  18.  
  19.  
  20.                        LIBRARY AND HEADER FILE INFORMATION
  21.  
  22.          WHEN UPDATING, ALWAYS UPDATE THE HEADER FILES ALSO !!!
  23.  
  24.          The composite LIBs listed below contain all the functions des-
  25.          cribed in ASYNC.DOC and SUPLMNT.DOC.  As supplied on the disk
  26.          the LIBs are setup for linking using Microsoft C or Quick C.
  27.          If you use Turbo C you need to run the batch file, TCLIBS.BAT,
  28.          to convert the LIBs to Turbo C format.  If you use Zortech C,
  29.          you will need to run ZTCLIBS.BAT.
  30.  
  31.          The conversion is necessary because a few of the non-async
  32.          functions are written in C and call library functions that have
  33.          different names in Microsoft C, Turbo C, and Zortech C.  All
  34.          the C code used is included in the shareware version so that if
  35.          you are using a compiler, other than one of the above, that
  36.          does use Microsoft calling sequences, you can recompile the
  37.          code, update the composite LIBs, and still use the library.
  38.  
  39.          In addition, the following statements are contained in COMM.H,
  40.          ANSIDRV.H, and EXTRA.H:
  41.  
  42.                          #if !defined(MCOMM)
  43.                            #define _C_ cdecl
  44.                            #define _N_ near
  45.                            #define _F_ far
  46.                            #define MCOMM
  47.                          #endif
  48.  
  49.          These definitions are not totally up to date with MSC 6.0 and
  50.          QC 2.5 (they have added a leading underscore for ANSI compat-
  51.          ibility), however, they do still work with these compilers and
  52.          they also work with Turbo C 2.0, Zortech C, and previous
  53.          versions of Microsoft's compilers. If you are using a different
  54.          compiler, you may need to change the 'cdecl', 'near', and 'far'
  55.          keywords to the equivalent names used by your compiler.
  56.  
  57.  
  58.  
  59.  
  60.          Only the small model version of the LIBs is included in the
  61.          shareware version.
  62.  
  63.          COMPOSITE LIBS:
  64.             COMM_S.LIB     ;small model LIB of all routines
  65.             COMM_C.LIB     ;compact model LIB of all routines
  66.             COMM_M.LIB     ;medium model LIB of all routines
  67.             COMM_L.LIB     ;large model LIB of all routines
  68.             COMM_H.LIB     ;created by TCLIBS.BAT (only used by TC)
  69.  
  70.          CONVERSION LIBS: (used by TCLIBS.BAT, MSCLIBS.BAT, ZTCLIBS.BAT)
  71.             TC_XS.LIB      ;used to convert COMM_S to TC
  72.             TC_XC.LIB      ;used to convert COMM_C to TC
  73.             TC_XM.LIB      ;used to convert COMM_M to TC
  74.             TC_XL.LIB      ;used to convert COMM_L to TC
  75.             TC_XH.LIB      ;used to convert COMM_L to TC COMM_H
  76.             MSC_XS.LIB     ;used to convert COMM_S to MSC
  77.             MSC_XC.LIB     ;used to convert COMM_C to MSC
  78.             MSC_XM.LIB     ;used to convert COMM_M to MSC
  79.             MSC_XL.LIB     ;used to convert COMM_L to MSC
  80.             ZTC_XS.LIB     ;used to convert COMM_S to ZTC
  81.             ZTC_XC.LIB     ;used to convert COMM_C to ZTC
  82.             ZTC_XM.LIB     ;used to convert COMM_M to ZTC
  83.             ZTC_XL.LIB     ;used to convert COMM_L to ZTC
  84.  
  85.  
  86.          Zortech C Specific Information:
  87.  
  88.             The Zortech C IO.H file and MCOMM COMM.H file have a name
  89.             clash with the defined variable 'R_OK'.  Zortech has it
  90.             defined as 4 and MCOMM defines it as 0.  The MCOMM
  91.             documentation makes references to a return value of R_OK so
  92.             rather than define it out in COMM.H, I left it in.  I
  93.             thought it was better for you to get a compiler error that
  94.             you could find than defining out R_OK if __ZTC__ was defined
  95.             and you not knowing what was wrong when a function that was
  96.             supposed to return R_OK didn't (since R_OK was 4 instead of
  97.             0).  The solution is to define it out of COMM.H if __ZTC__
  98.             is defined and then everywhere an MCOMM function is supposed
  99.             to return R_OK, look for a return value of 0.
  100.  
  101.             Control-break locks up the SMALTERM demo programs.  I think
  102.             the problem is:  Zortech C control-break causes you to exit
  103.             to DOS where MSC and TC do not as long as only the BIOS key
  104.             functions are used.  When SMALTERM exits to DOS with the
  105.             interrupts still hooked, the demo crashes. This only applies
  106.             to Zortech C/C++.  I tried using the signal functions to fix
  107.             it but didn't get it.  If you are an experienced Zortech
  108.             user and want to tell me how to make Zortech C run the exit
  109.             term function when control-break is pressed before it exits
  110.             to DOS, I will correct it for the next version.
  111.  
  112.